Colour DOS 



A guidline for the Disk Operating System 
of tine EACA EG2000 Colour Genie Computer 



Table of Contents. 

1. Introduction 1 

2. Floppy disk composition 2 

3. File formats 4 

4. The File Control Block (FCB) 5 

5. DOS routines 6 

6. Interrupt routine format 15 

7. Compatibility with TRS 80 / Video Genie Operating Systems 16 

8. Floppy disk formats 17 

9. Reading alien floppy disks 18 

Appendix A: Disk BASIC Memory usage 19 

Appendix B: Memory map 20 

Appendix C: Error codes 21 

Appendix D: System Entry Table 23 

Appendix E: Description of the Restart commands 24 

Appendix F: Vector tables for DOS / Disk BASIC 25 

Appendix G: Program examples 27 



1. Introduction 

This document contains lielpful information about tine functioning and a more extensive use of DOS on tine 
EG2000 Colour Genie computer. It gives an overview of the details of DOS, and how to access DOS from 
assembly language programs. Some program examples are included. 



2. Floppy disk composition 



This chapter gives an overview of the way that floppy disks are formatted and how the data on the floppy disk is 
distributed and managened. 

The smallest data unit on a floppy disk is one sector. One sector always contains 256 bytes. Sectors are 
numbered. Machine programs can access sectors directly for either read or write operations. 

Every 5 consecutive sectors form a granule (1280 bytes). In a normal floppy disk composition in files, that are 
addressed with their filename, the granule is the smallest addressable unit. This means that every file occupies 
a certain number of granules. This can lead to the situation that DOS reports a floppy disk that contains a lot of 
small files as full, although the majority of sectors is unused. 

Another unit that is important in the use of DOS, is the lump. The size of a lump depends on the floppy disk 
format: 

Floppy disk format Granules per lump 

A, E, I (SS, SD) 2 

B, F, J (DS, SD) 4 

C, G, K (SS, DD) 3 

D, H, L (DS, DD) 6 



During formatting, 2 system files a written onto the floppy disk. These system files are hidden, and are not 
listed using the CMD'T' command: 

DIR/SYS 

This file contains the directory of the floppy disk. This is the only file that contains protected sectors. This 
means, that when reading this file, an error 6 is reported. This serves as an extra protection and recognition of 
this file. DIR/SYS differs in length depending on the floppy disk format. 

NCW1983/JHL 

This file always occupies the first granule (sector to 4) on the floppy disk. Its main task is to make the floppy 
disks compatible with the operating systems for the TRS 80 and Video Genie computers (there it is called 
BOOT/SYS and it contains the load routine for DOS). On the Colour Genie, only the third byte of the first sector 
is important; it indicates, in which lump on the floppy disk, the directory starts. 

For studying the floppy disk composition, a program like Colour-Zap is strongly recommended. Such a program 
allows you to look at the sectors on the floppy disk. 

The first sector of DIR/SYS contains information about the floppy disk. The bytes OOH to 05H indicate the free 

granules on the floppy disk. Every byte corresponds with one lump. Starting with bit 0, only that number of bits 

is used, that corresponds with the number of granules per lump. So, bit of the first byte indicates whether the 

first granule on the floppy disk is occupied (this granule is always occupied by NCW1983/SYS). If a granule is 

occupied, the corresponding bit is set to 1. Unused bits are always set to 1. A completely used lump has its 

corresponding byte set to FFH. 

The bytes 60H to BFH are not used by the Colour Genie. They are used in some TRS80/Video Genie operating 

systems to indicate defective granules. 

The bytes DOH to D7H contain name, the bytes D8H to DFH contain the date of the floppy disk. 

The remaining bytes of the first sector have no meaning on the Colour Genie. 

The second sector of DIR/SYS contains the hash code table for several files. Here, for every file, a hash code 
from the name is stored to speed up the search of a file. The position of a hash code in the second sector 
indicates, where the real entry in DIR/SYS is located. When one would imagine this sector as a table with 8 
rows and 32 columns, then every column contains the hash codes for one of the next sectors. Column for the 
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third sector, column 1 for the fourth sector etc.. When a byte is 0, it means that there is no file entry at the 
corresponding location. 

Byte 1FH of the second sector has a special meaning. It indicated the length of DIR/SYS-10. So, when is 
contains 5 (as with SS/DD floppy disks), DIR/SYS is occupies 15 sectors. 

The next sectors contain the file entries for the files present. Every file uses a block of 32 bytes, one sector 
can hold up to 8 files. There are 2 types of entries: 

The first (and in most cases only) entry for a file and its continuation (necessary for long files, when the file is 
stored on different locations on the floppy disk). The bytes of the first entry contain following information: 

Byte 0: Bit Meaning when set 

7 Always 

6 System file 

5 No meaning 

4 Entry in use, contains a file 

3 Hidden file, not listed using CMD'T' 

2-0 Always on the Colour Genie 

Byte 1 : Bit Meaning when set 

7 Always 

6 System file 
5-0 No meaning 

Byte 2: No meaning 

Byte 3: Indicates which byte in the last sector of the file does not belong to the file 

anymore. Here the rule is 0=256. 

Byte 4: Not used by DOS 

Bytes 5-12: Contain the file name, padded with spaces. 

Bytes 13-15 Contain the file extension. 

Bytes 16-19: Always on the Colour Genie 

Bytes 13-15 Indicate how many sectors are used by this file. 



The remaining bytes indicate the location of the data. It is possible that the file is divided into several blocks. 

For this reason, 4 pairs of bytes are reserved. If they are not sufficient, the file will obtain a second entry. 

When the first byte of a pair equals FFH, the file has no more following blocks. The remaining byte pairs are 

meaningless. 

When the first byte of a pair equals FEH, the file has an additional entry in the directory. The second byte 

indicates the location of the entry; the bits 0-4 show in which sector, and the bits 57 indicate which entry 

within the sector. 

Otherwise, the first byte shows in which lump the data block belonging to the file starts. Bits 5-7 in the second 

byte then show, in which granule of this lump the data block starts, and the bits 0-4 indicate the length of the 

data block (in granules). 

An additional entry of a file can be recognised by bit 7 of byte 0. Whenever this bit is set to 1 , then byte 1 
indicates the location of the previous entry (see above). Bytes 2-12 stay unused, and the bytes 23-31 have the 
same meaning as described above. 

The separation of files into several data blocks may look somewhat complicated, but it allows to use of every 
free granule on the floppy disk. 

Deleting a file is done by setting the first byte of the file entry and the hash code to zero. The disk space 
occupied by this file is then released. The data and all file entries remain unchanged. 



3. File formats 

This chapter gives an overview of the way that programs are stored on the floppy disk. 

BASIC programs starts with a byte set to FFH. After that follows the program as it is stored in memory. 

BASIC programs saved with the SAVE" ",A option, contain the ASCII characters, that are also shown by the 
LIST command. 

Pascal source files created with the Colour Pascal 2.0 compiler are also stored as a text file containing the 
ASCII characters of the source file. 

Machine language programs have a more complex format: 

They are divided into blocks of 256 bytes maximum. Every block contains 4 extra bytes of load information: 

Byte Meaning 

1 1 = Load data block. 

2 = Last data block. 

3 = Ignore data block. 

2 Length+2: 2 means 256 bytes, 1 means 255 bytes, etc.. 
3-4 Load address of the data block 

The last block of a file has only 4 bytes, 2 times 2 followed by the entry address of the program. 



4. The File Control Block (FCB) 



This chapter gives information about the FCB structure and the usage of an FCB. 

To every opened file, a File Control Block is assigned. This FCB is the only connection to the file on the floppy 
disk. The computer does not store if and how many files are opened, but installs a FCB. All operations use and 
go through the FCB. 

When using DOS routines, the address of the FCB used must be stored in register DE. Also, a buffer of 256 
bytes is needed for every file, to read data into. The address of this buffer must be indicated when the file is 
opened. 

The programmer indicates, when opening a file, where the FCB is located in memory. This requires a 32 byte 
memory area, that must be reserved for this purpose only. 

Normally, DOS routines manage the FCB themselves; the programmer has just to call the right routines. It is 
however possible, to change the FCB for own purposes. The meaning of the bytes inside the FCB are as 
follows: 



Byte 0: Bit Meaning when set 

7 File opened 

6-2 No meaning 

1 File uses the complete floppy disk 

Sectors are written protected (only DIR/SYS) 

Byte 1 : Bit Meaning when set 

7 Always 

6 System file 

5 Buffer contains data of the next sector 

4 Buffer contains data that still has to be written 

3 Always set on the Colour Genie 

2-0 Always on the Colour Genie 

Byte 2: Identical to byte 1 of the directory entry 

Byte 3-4: Contain the address of the buffer 

Byte 5: Indicates which byte of the current sector will be read/written next 

Byte 6: Contains the used drive number 

Byte 7: Contains the corresponding directory entry position 

Byte 8: Identical to byte 3 of the directory entry 

Byte 9: Contains the record length (0=256 bytes) 

Bytes 10-11: Indicate the current sector that is processed 

Bytes 1 2-21 : Correspond with the bytes 20-29 of the directory entry 

Bytes 22-23 FFH, if the file has only one directory entry. Else, they indicate the location of the 

second directory entry. 

Bytes 24-31 : Correspond with the bytes 22-29 of the second directory entry (if present) 



For the use of most DOS routines, the address of the used FCB must be loaded into register pair DE. After 
returning, the zero flag is cleared in case no error occurred. If an error occurred, register A contains the error 
number. The error code is identical to the DISK-Error messages. 



5. DOS routines 



A list of the DOS routines, witli a sliort description will follow. First, the register values that are expected are 
indicated. After that, the return values are given. If nothing else is mentioned, the routine will not change any 
registers except AF. 



File Open : CE24H 

Entry: 



DE 

HL 

B 

in FCB 



FCB address 
Buffer address 
Record length 
Filename 



Return: 



AF 
in FCB 



Error code 
see FCB 



This routine opens an existing file on the floppy disk. The filename in the FCB must follow the usual 
conventions and must end with a 03 or ODH. HL points to a buffer with a minimum size of 256 bytes. 
Register B indicates the record length. This means how many bytes are processed at a read or write operation. 
With B = 0, data are processed sector wise, so with 256 bytes at a time. All values from to 255 are valid. 



File Initialise : CE20H 

Entry: 



DE 

HL 

B 

in FCB 



FCB address 
Buffer address 
Record length 
Filename 



Return: 



AF 
in FCB 



Error code 
see FCB 



This routine is similar to the file open, which is called first. When the file however does not exist, the file is 
created on the floppy disk. Therefor, this routine should only be used for write operations. 

Read and write of single bytes. 

For reading / writing single bytes, special easy to use routines are available. When opening the file, the record 
length must be put into register B. 

Read one byte : 001 3H 

Entry: 

DE FCB address 

Return: 



AF Byte read, or error code when zero flag is clear. 



Write one 


byte 


:001BH 


Entry: 






DE 




FCB address 


A 




Byte to be written 


Return: 






AF 




Error code 



Read one record : CE36H 

Entry: 

DE FCB address 

HL : When record length = : buffer address 

Return: 

AF Error code 

in buffer: Data read. 

This routine reads one record. The record length is determined when the file is opened. If one works sector 
wise, the sector that is read is stored in the buffer that is indicated when the file is opened. If the record length 
= 0, the record is stored into a second buffer; register pair HL contains the address of this buffer. 

Write on record : CE39H or CE3CH 

Entry: 

DE FCB address 

HL When record length = : buffer address 

Return: 

AF Error code 

This Dutine writes one record. The record length is determined when the file is opened. If one works sector 
wise, the data must be present in the buffer that is indicated when the file is opened. Otherwise, the data must 
be present in a second buffer; register pair HL contains the address of this buffer. Routine CE3CH also verifies 
the data written. 

Fiie Ciose : CE28H 

Entry: 

DE FCB address 

Return: 

AF Error code 



This routine closes a file a writes all necessary information onto the floppy disk. This routine must only be 
called, when the file has changed due to write operations. 



Random Access Routines. 

The following routines enable you to change the NEXT pointer that determines which record has to be read or 
written next. 



Set NEXT to BC : CE42H 


Entry: 




DE 


FCB address 


BC 


Record number 



Return: 

AF Error code 

This routine puts the NEXT pointer on the record indicated by the record number stored in register pair BC. 

Set NEXT to : CE3FH 

Entry: 

DE FCB address 

Return: 

AF Error code 

This routine puts the NEXT pointer to the start of the file. 

Set NEXT to EOF : CE48H 

Entry: 

DE FCB address 

Return: 

AF Error code 

This routine puts the NEXT pointer to the end of file (only useful for writing). 



Set NEXT to byte address : CE4EH 


Entry: 




DE 


FCB address 


HLC 


Byte address 



Return: 



AF Error code 

This routine puts tine NEXT pointer onto a byte, addressed by tine 3 byte address stored into tlie registers HLC. 
Tliis routine is useful wlien working witli tlie byte routines 001 3H and 001 BH. 



Decrement NEXT : CE45H 

Entry: 

DE FCB address 

Return: 

AF Error code 

Tliis routine decrement the NEXT pointer; the record last processed is used again. 

Check Filename and copy into FCB : CE1CH 

Entry: 



DE 


FCB address 


HL 


Address of filename 


Return: 




AF 


Error code 



This routine checks the indicated filename. If it complies to the rules, it will copy it into the FCB so that the file 
can be opened. 



File Delete : CE2CH 

Entry: 

DE FCB address 

Return: 

AF Error code 

This routine deleted the directory entry that belongs to the opened file. 



Load Machine 


code program : 


: CE30H 


Entry: 






DE 


FCB address 




in FCB : 


Filename 




Return: 
AF 


Error code 





This routine opens tine indicated file and loads the machine code program into memory. 

Execute Machine code program : CE33H 

Entry: 

DE FCB address 

in FCB : Filename 

(does not return) 

This routine opens the indicated file, loads the machine code program into memory and jumps to the entry 
address when no error occurred. If an error occurred, a DISK-Error message is given. 

Enter EOF into Directory : CE51 H 

Entry: 

DE FCB address 

Return: 

AF Error code 

This routine enters an end of file into the directory of the floppy disl<. 

The routines mentioned before mai^e full usage of files from machine code programs possible. There are 
however more routines available, that allow access to the floppy disl< without using files. They should be used 
with care, since a wrong usage can destroy data on the floppy disi^. 

Drive Select : CE5BH 

Entry: 

A Drive number 

Return: 

AF Error code 

This routine selects the drive for the all following read/write operations. 

Drive Test : CE5EH 

Entry: 

A Drive number 

Return: 

AF Error code 
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This routine selects tlie drive A and tests, wlietlier tine drive is ready and if a floppy disk is inserted. 

Read Sector : CF6FH 

Entry: 

DE Sector number 

HL : Buffer address 

Return: 

AF Error code 

in buffer: Data read 

This routine reads one sector and stores the data in a buffer. The sector number is present in register pair DE; 
the buffer address in register pair HL. 

Test Sector : CF73H 

Entry: 

DE Sector number 

Return: 

AF Error code 

This routine test if a sector can be read. 

Write Sector : CF7FH 

Entry: 



DE 


Sector number 


HL 


Buffer address 


in buffer: 


Data to be written 


Return: 




AF 


Error code 



This routine writes the data from a buffer to a floppy disk sector. The sector number is present in register pair 
DE; the buffer address in register pair HL. 



Write Protected Sector : CF7BH 


Entry: 




DE 


Sector number 


HL 


Buffer address 


in buffer: 


Data to be written 



Return: 



II 



AF Error code 

This routine writes tine data from a buffer to a floppy disk sector. Tine sector number is present in register pair 
DE; tine buffer address in register pair HL. Tine sector is written witli a mark. Tliis normally only happens with 
directory sectors. When such a sector is read, an error 6 occurs. 



Re-select Drive : CE16H 

Return: 

AF corrupted 

This routine again selects the last selected drive. 



Read Directory 


sector : D25FH 


Entry: 




A 


Directory sector numbe 


Return: 




AF 


Error code 


HL 


Buffer address (5900H) 



This routine reads a directory sector (A contains the sector number) and stores it into the system buffer at 
5900H. 



Write Directory 


sector : D274H 


Entry: 




in system buffer 


: Data to be written 


Return: 




AF 


Error code 


HL 


corrupted 



This routine writes the directory sector last read back to the floppy disk. 

One should take care using the write routines. A floppy disk with a damaged directory becomes unreadable in 
most cases. 

DOS also contains additional routines, that are not related to the usage of floppy disks, but can also be useful. 



Issue Error Message : CE90H 

Entry: 

A Error code 

This routine generates a DISK-Error message and returns to BASIC. 
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Multiply 


CE76H 


Entry: 




HL 
A 


Multiplicand 
Multiplier 


Return: 




AHL 


Result 



This routine performs a multiplication. The result has a length of 3 bytes maximum. 



Division 


: CE79H 


Entry: 




HL 


Dividend 


A 


Divisor 



Return: 



HL 


Result 


A 


Fraction 


BC 


corrupted 


Give Tin 


ne : CE6DH 


Entry: 




HL 


Buffer address 


Return: 




in buffer: 


The time as an 8 byte string 


BC 


corrupted 


DE 


corrupted 


HL 


corrupted 



The time string uses the format hh:mm:ss. 



Give Date : CE70H 



Entry: 



HL 



Buffer address 



Return: 



in buffer: 


The date as an 8 byte string 


BC 


corrupted 


DE 


corrupted 


HL 


corrupted 
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The date stored in the memory locations 4044H - 4046H is put in the buffer using the format dd.mm.yy 

Insert Interrupt routine : CE10H 

Entry: 

DE Address of the routine to be inserted 

Return: 

DE corrupted 

HL corrupted 

This routine inserts a program present in memory into the interrupt chain. This call has the same effect as the 
CMD "Y address" statement in BASIC. The program must not already be a part of the interrupt chain! It may 
not corrupt any Z80 register. This DOS call also executes a El instruction. 

Remove Interrupt routine : CE13H 

Entry: 

DE Address of the routine to be removed 

Return: 



BC 


Corrupted 


DE 


Corrupted 


HL 


Corrupted 



This routine removes a program from the interrupt chain. This call has the same effect as the CMD"V address" 
statement in BASIC. This DOS call also executes a El instruction. 
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6. Interrupt routine format 

On the Colour Genie, it is possible to insert routines in a so called interrupt chain. Every 25 milliseconds, the 
computer walks through this chain and looks if routines should be executed. 
A routine in this chain must have the following header: 

Address Description 

xxxx+O , xxxx+1 Vector to next interrupt routine (set by system) 

xxxx+2 Initial timer value 

xxxx+3 timer counter value 

xxxx+4 Entry address of the interrupt routine . 



Inserting the routine is done from BASIC by using the CMD"Y xxxx" statement or by executing DOS call 

CE10H with the address xxxx in register DE. The system then inserts it into the chain and stores the vector of 

the next interrupt routine in the header. The address xxxx+2 contains a initial timer value. 

The timer counter value at xxxx+3 is decremented every timer tick of 25 ms. When it reaches zero, the 

interrupt routine is executed and the initial timer value on address xxxx+2 is copied to the timer counter value of 

xxxx+3. 

The address xxxx+4 is the entry address of the interrupt routine, here is where the executable code starts. The 
routine must not corrupt any registers or the stack! 

Note that the Z80 CPU must be in interrupt mode 1 (IM 1) to perform the executing of the interrupt chain. 
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7. Compatibility with TRS 80 / Video Genie Operating Systems 

The most important routines in DOS are compatible witli tine corresponding routines of tine most TRS80 / Video 
Genie Operating Systems. Tine following routines are present in all these operating systems: 

Colour Genie TRS 80 / Video Genie 

0013H 0013H 

OOIBH OOIBH 

CE20H 4 42 OH 

CE24H 4424H 

CE36H 4436H 

CE39H 4439H 

CE3CH 443CH 

CE42H 4442H 

CE28H 4428H 

CE2CH 442CH 

Other routines are not present in all operating systems. A routine that starts at CEXXH on the Colour Genie, 
starts at 44XXH on the TRS 80 / Video Genie 

The floppy disks are fully exchangeable. The formats for BASIC and machine code programs is identical. 
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8. Floppy disk formats 

The Colour Genie DOS can handle the following floppy disks formats: 

SS = Single Sided 
DS = Double Sided 

SD = Single Density 
DD = Double Density 



Sided 

SS 
SS 
SS 
SS 
DS 
DS 
DS 
DS 



Density 



SD 
DD 
SD 
DD 
SD 
DD 
SD 
DD 



Tracks 

40 
40 
80 
80 
40 
40 
80 
80 



Sector/Track 


Total Sectors 


Capaci 


10 


400 


102 


18 


720 


184 


10 


800 


204 


18 


1440 


368 


20 


800 


204 


36 


1440 


368 


20 


1600 


408 


36 


2880 


736 



In order to achieve the right format, the floppy disk drive has to be set to the proper drive type. This can be done 
with the CMD"< drive# = Type" statement in BASIC. The drive# indicates for which of he 4 drives (0..3) the new 
type applies. Default at start-up is drive type C. 



Type 



A 
B 
C 
D 
E 
F 
G 
H 
I 
J 
K 
L 



Floppy (Tracks) 


Drive (Tracks) 


40 


40 


40 


40 


40 


40 


40 


40 


40 


80 


40 


80 


40 


80 


40 


80 


80 


80 


80 


80 


80 


80 


80 


80 



Density 

SD 
SD 
DD 
DD 
SD 
SD 
DD 
DD 
SD 
SD 
DD 
DD 



Sided 

SS 
DS 
SS 
DS 
SS 
DS 
SS 
DS 
SS 
DS 
SS 
DS 



The types E, F, G and H are necessary for reading a 40 track floppy disk on a 80 track disk drive. 
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9. Reading alien floppy disks 



It is possible for the Colour Genie to read floppy disks, that are made on the Genie l/ll/lll computers. Important 
are the Pdrive (see G-DOS manual) correspond to the settings of the Colour Disk BASIC, since no adaptation 
is possible from within the Colour Disk BASIC. 



Following settings are required by the Colour Genie, so that alien floppy disks can be read: 



Type 



A 

B 
C 
D 
E 
F 
G 
H 
I 
J 
K 
L 



Type 


Type 


Interface 


Drive 


A 


A 


A 


C 


CK 


E 


CK 


G 


AL 


A 


AL 


C 


CKL 


E 


CKL 


G 


A 


A 


A 


C 


CK 


E 


CHK 


G 



Units 


Number Dir. 


Start Block 


In Block 


Units 


Directory 


2 


2 


20 


4 


4 


20 


3 


3 


24 


6 


6 


24 


2 


2 


20 


4 


4 


20 


3 


3 


24 


6 


6 


24 


2 


2 


40 


4 


4 


40 


3 


3 


48 


6 


6 


48 



Floppy disks, made on the Colour Genie, can be read on the Genie 
value for Start Block Directory however does not have to match. 



using the Pdrive settings above. The 



Note that the Pdrive settings are not put on the floppy disks by the Colour Genie and a call of this table on a 
Genie l/ll/lll causes an error. 
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Appendix A: Disk BASIC Memory usage. 

Disk BASIC needs parts of the BASIC system memory (4000H - 43FFH) and parts of the normal memory from 
5800H to 5C9AH, followed by the buffers (0-9) needed by files that are used by BASIC programs. Then the 
memory for BASIC programs follows. 

The following memory locations are important under DOS : 



4040H 




4041H 




4042H 




4043H 




4044H - 


4046H 


4050H - 


4056H 


4057H - 


405DH 


405EH 




4076H 




407CH - 


407DH 


408EH 




43CEH - 


43E1H 


43E3H 




43ECH - 


43FFH 


5800H - 


58FFH 


5900H - 


59FFH 


5A08H 




SAO AH - 


5A13H 


5A71H - 


5A98H 


CEAOH - 


CF17H 



25 milliseconds counter for the time 

Seconds counter 

Minutes counter 

Hours counter 

Date 

Interrupt routine for the time 

Interrupt routine for displaying the time 

Number of last read directory sector (for write 

routine at D274H) 

Hash code of the last opened file 

Entry address for a program loaded with CMD"L" 

Number of files in Disk BASIC 

Disk BASIC FCB addresses (2 byte pairs) 

Error code of last reported Disk Error 

USR functions entry addresses (2 bytes pairs) 

Buffer for Close and Kill 

System buffer for reading of directory 

Actual drive number 

Actual drive data 

Data for drives 0-3 

Data for drive types A — L 



Drive data are loaded from EPROM to 5A71H - 5A98H when a CMD"<" statement is executed. When a drive is 
selected, the drive data of the selected drive is copied to 5A0AH - 5A13H. This data block has to following 
contents : 



5A0AH 
5A0BH 
5A0CH 
5A0DH 
SAO EH 
5A0FH 
5A10H 
5A11H 
5A12H 
5A13H 



Number of first lump belonging to directory 

Number of lumps on floppy disk 

Stepper motor speed: 7 for SD, 53H for DD 

Number of tracks (40/80) 

Number of sectors per track 

Number of granules per lump 

Always 

Flags used for control of floppy disk controller 

Number of sectors per granule (always 5) 

Directory length in granules 
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Appendix B: Memory map 



ROM Cartridge (1 KB) 



Keyboard Matrix (1 KB) 



User-definable Characters (1 KB) 



Cliaracter Colour Memory (1 KB) 



DOS Utilities (4 KB) 



DOS Routines {4V4 KB) 



DOS Vectors ('A KB) 



BASIC Vectors (3y2 KB) 



User RAM (EG 2011) (16 KB) 



User RAM (8 KB) 



Program Buffers 1 to 3 (1 at lowest address) (1 V2 KB) 



I/O Buffer (DOS) ('A KB) 



Floppy Disk Buffer ('A KB) 



Graphic Screen Memory (4 KB) 



Text Screen Memory (1 KB) 



Vectors, Marks and System Variables (DOS and BASIC) (1 KB) 



BASIC Interpreter (EPROM) (16 KB) 



Hex 


Decimal 


Peek/Poke 


FFFF 


65535 


-1 


FCOO 


64512 


-1024 


FBFF 


64511 


-1025 


F800 


63488 


-2048 


F7FF 


63487 


-2049 


F400 


62464 


-3072 


F3FF 


62463 


-3073 


FOOO 


61440 


-4096 


EFFF 


61439 


-4097 


EOOO 


57344 


-8192 


DFFF 


57343 


-8193 


CFOO 


52992 


-12544 


CEFF 


52991 


-12545 


CEOO 


52736 


-12800 


CDFF 


52735 


-12801 


COOO 


49152 


-16384 


BFFF 


49151 


-16385 


8000 


32768 


-32 768 


7FFF 


32767 


32767 


6000 


24576 


24576 


5FFF 


24575 


24575 


5A00 


23040 


23040 


59FF 


23039 


23039 


5900 


22784 


22 784 


58FF 


22783 


22 783 


5800 


22528 


22528 


57FF 


22527 


22527 


4800 


18432 


18432 


4 IFF 


18431 


18431 


4400 


17408 


17408 


43FF 


17407 


17407 


4000 


16384 


16384 


3FFF 


16383 


16383 



0000 
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Appendix C: Error codes 



The following table contains the error codes and their meaning. This table is also valid for the G-DOS operating 
system (Genie l/ll/lll) and contains therefor some error codes that can not occur under the Colour Disk BASIC. 



Error description 



No error 

Bad file data 

Read error: search error 

Read error: data lost 

Read error: checksum error 

Read error: record not found 

Read error: trying to read protected sectors 

Read error: trying to read system sectors 

Device unreachable 

Undefined error code 

Write error: search error 

Write error: data lost 

Write error: checksum error 

Write error: record not found 

Write error on disk drive 

Floppy disk is write protected 

Peripheral device unreachable 

Directory read error 

Directory write error 

Illegal filename 

Track number too high 

Illegal DOS call function 

Undefined error code 

Undefined error code 

File not in directory 

Access denied by file 

Directory full 

Floppy disk full 

End of file reached 

Beyond end of file 

Directory full : cannot extend file 

File not found 

Illegal or missing disk drive 

No device reachable 

Load error: bad format 

Memory error 

Try to load in ROM 

Load error: access denied 

File not open 

Illegal initialisation data on floppy disk 

Illegal track number 

Illegal logical filenumber 

Illegal DOS function 

Illegal function under chaining 

Directory incorrect 

Bad FCB data 

System program not found 

Bad parameter 
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Code 




Decimal 


Hex 





00 


1 


01 


2 


02 


3 


03 


4 


04 


5 


05 


6 


06 


7 


07 


8 


08 


9 


09 


10 


OA 


11 


OB 


12 


OC 


13 


OD 


14 


OE 


15 


OF 


16 


10 


n 


11 


18 


12 


19 


13 


20 


14 


21 


15 


22 


16 


23 


17 


24 


18 


25 


19 


26 


lA 


21 


IB 


28 


IC 


29 


ID 


30 


IE 


31 


IF 


32 


20 


33 


21 


34 


22 


35 


23 


36 


24 


37 


25 


38 


26 


39 


27 


40 


28 


41 


29 


42 


2A 


43 


2B 


44 


2C 


45 


2D 


46 


2E 


47 


2F 



48 


30 


49 


31 


50 


32 


51 


33 


52 


34 


53 


35 


54 


36 


55 


37 


56 


38 


57 


39 


58 


3A 


59 


3B 


60 


3C 


61 


3D 


62 


3E 



No filename 

Bad floppy disk type 

Read error BOOT 

Fatal DOS error 

Illegal abbreviation, separator or end marker 

File already exists 

Command too long 

Access denied by floppy disk 

Not a Mini-DOS function 

Forced termination of function 

Difference at verify 

Insufficient memory 

Incompatible drive or floppy disk 

ADE=N attribute, cannot extend file 

Cannot extend file at read 
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Appendix D: System Entry Table 



Address 



Name 



Description 



CEO OH 
CE05H 
CE08H 
CE09H 
CEODH 
CEIOH 
CE13H 
CE16H 
CE19H 
CEICH 
CE20H 
CE24H 
CE28H 
CE2CH 
CE30H 
CE33H 
CE36H 
CE39H 
CE3CH 
CE3FH 
CE42H 
CE45H 
CE48H 
CE4BH 
CE4EH 
CE51H 
CE54H 
CE5BH 
CE5EH 
CE67H 
CE6AH 
CE6DH 
CE70H 
CE76H 
CE79H 
CE79H 
CE80H 



$DOS 

$DOSCMD 

$NERROR 

$DERROR 

$ DEBUG 

$ENQUE 

$DEQUE 

$RESEL 

$DOSCAL 

$EXFIL 

$INIT 

$OPEN 

$CLOSE 

$KILL 

$LOAD 

$RUN 

$RDSEC 

$WRSEC 

$WRSECV 

$POS0 

$POSBC 

$POSDEC 

$POSEOF 

$ALLOC 

$POSBRA 

$WREOF 

$DELIM 

$DRVSEL 

$DSKMNT 

$PRINT 

$LPRINT 

$CONTIM 

$CONDAT 

$MULT 

$DIV 

$HEXDE 

DOSFCB 



Return to command mode 

Calls machine code program or DOS command 

RET Z, else 

Report error message 

Call system monitor 

Insert interrupt routine 

Remove interrupt routine 

Reselect current disk drive 

as $DOSCMD, but returns 

Examine and transfer filename into FCB 

Initialises file and opens FCB 

Opens FCB for current file 

Closes FCB 

Deletes file entry 

Loads machine code program 

Runs machine code program 

Reads sector 

Writes sector 

Writes and verifies sector 

Set FCB sector number to zero 

Set FCB sector number to (BC) 

Decrements FCB sector number 

Sets FCB sector number at end of file 

Reserves unit on floppy disk for file 

Positions FCB at relative byte address 

Write end of file into directory 

Tests delimiters at parameters 

Selects disk drive 

Tests if floppy disk in drive 

Prints text on screen 

Prints text on printer 

Gives time as 8 bytes string 

Gives date as 8 bytes string 

Multiply A*HL=AHL 

Divides HL div A=HL mod A 

Gives hexadecimal representation of DE 

System internal FCB of 32 byte length 
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Appendix E: Description of the Restart commands 

The Restart commands (RST) are subroutines in Z80 macliine language (like CALL routines). The advantage of 
RST commands is that they use little memory. A CALL command uses 3 bytes; a RST command uses only 1 
byte. The following routines are used as subroutines in Colour Disk BASIC: 

RST 00 Jumps to memory location and corresponds with a cold boot 

RST 08 Syntax check 

The memory address that is addressed by HL is compared to the byte following the RST 08. If 
they are equal, a RST 10 is executed, else a syntax error is reported. 

RST 10 Loads the memory location addressed by HL+1 into the accumulator A. 

Blanks and Linefeeds are skipped. Digits cause the setting of the Carry -flag, a ':' or a 00 cause 
the setting of the Zero-flag 

RST 18 Compares HL with DE register pair 



HL>DE 
HL = DE 
HL<DE 



Zero-flag=0, Carry-flag=0 
Zero-flag=1 , Carry-flag=0 
Zero-flag=0, Carry-flag=1 



RST 20 Tests the type of the contents of the X-register stored at address 40AFH. 

Integer: Zero-flag=0, Carry-flag=1 , Parity-Flag=1 , Sign-Flag=1 

Single: Zero-flag=0, Carry-flag=1, Parity-Flag=0, Sign-Flag=0 

Double: Zero-flag=0, Carry-flag=0, Parity-Flag=1, Sign-Flag=0 

String: Zero-flag=1, Carry-flag=1, Parity-Flag=1, Sign-Flag=0 

RST 28 Used to load a system module. The Accumulator A contains the loader 

code. RST 28 is also called when pressing the BREAK key. 

RST 30 Generally used to call a DEBUG program. It returns after termination of the 

DEBUG program. 

RST 38 This routine is executed every 25 milliseconds if the Z80 CPU is set to 

interrupt mode 1 (IM 1) 
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Appendix F: Vector tables for DOS / Disk BASIC 

The system variable space between 4000H and 43FFH contains tine vectors for tine Disk BASIC statements and 
the vectors into DOS. Every vectors requires 3 bytes (space necessary for a absolute jump instruction). 

The first table occupies the area from 4152H to 41 ASH. It contains the vectors for the Disk BASIC statements. 
Under Level II BASIC, these vectors all contain a jump to 013BH in the BASIC interpreter ROM area. Under 
Disk BASIC, the vectors contain a jump to the following addresses: 

Address (Dec, Hex) Jump to: Statement 

cvi 

FN 

CVS 

DBF 

CVD 

EOF 

LOC 

LOF 

MKI$ 

MKS$ 

MKD$ 

CMD 

TIME$ 

OPEN 

FIELD 

GET 

PUT 

CLOSE 

LOAD 

MERGE 

NAME 

KILL 

none (Previous &) 

LSET 

RSET 

INSTR 

SAVE 

LINE 



16722 


4152H 


C565H 


16725 


4155H 


C3AEH 


16728 


4158H 


C562H 


16731 


415BH 


C353H 


16734 


415EH 


C55FH 


16737 


4161H 


CA25H 


16740 


4164H 


CA04H 


16743 


4167H 


C9FFH 


16746 


416AH 


C54EH 


16749 


416DH 


C54BH 


16752 


4 17 OH 


C548H 


16755 


4173H 


C2FBH 


16758 


4176H 


C24DH 


16761 


417 9H 


CB5CH 


16764 


417CH 


C5D0H 


16767 


417FH 


CAAIH 


16770 


4182H 


CAAOH 


16773 


4185H 


C9C4H 


16776 


4188H 


C8D6H 


16779 


418BH 


C962H 


16782 


418EH 


CCOEH 


16785 


4191H 


CBEBH 


16788 


4194H 


1E4AH 


16791 


4197H 


C57EH 


16794 


417AH 


C57FH 


16797 


419DH 


C456H 


16800 


41A0H 


C99CH 


16803 


41 ASH 


C65BH 
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The second table contains the BASIC vectors into DOS. Under Level II BASIC, these vectors contain a return 
instruction followed by 2 nops to fill the remaining 2 bytes memory space reserved for each vector. Under Disk 
BASIC, the vectors contain a jump to the following addresses: 



Address (Dec, Hex) 



Jump to: 



Description 



16806 


41A6H 


16809 


41A9H 


16812 


41ACH 


16815 


41AFH 


16818 


41B2H 


16821 


41B5H 


16824 


41B8H 


16827 


41BBH 


16830 


41BEH 


16833 


41C1H 


16836 


41C4H 


16839 


41C7H 


16842 


41CAH 


16845 


41CDH 


16848 


41D0H 


16851 


41D3H 


16854 


41D6H 


16857 


41D9H 


16860 


41DCH 


16863 


41DFH 


16866 


41E2H 



C1D3H 
C390H 
C959H 
C6BBH 
C98BH 
C75FH 
C76EH 
C9F5H 
C685H 
C6F2H 
C701H 
C8D3H 
C62AH 
C77CH 
C77BH 
C74 7H 
C68DH 
C4DAH 
C7C2H 
C6A5H 
CC16H 



Error routine 

USR 

Return to active cornmand mode 

Input line 

After tokenizing 

After accepting a new program line 

After accepting a new program line 

Clear after cleaning all variables 

After ending printer output 

Character output 

Keyboard read at program execution 

RUN 

PRINT 

PRINT (numeric value) 

Start of a new program line 

PRINT or PRINTTAB 

INPUT 

MID$ left of = sign 

Data processing after READ / INPUT 

Termination of INPUT 

SYSTEM 
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Appendix G: Program examples 



Error report with return to program: 



ERROR 



TEXTl 



PUSH 


HL 






PUSH 


AF 






CALL 


2169H 




; Output to scr 


CALL 


20F9H 




; Cursor to sta 


LD 


HL, TEXTl 




CALL 
POP 


2B75H 
AF 




/Output text 


LD 


L,A 






LD 


H, 




; Error code to 


CALL 


OFAFH 




; Output HL 


CALL 
POP 


20FEH 
HL 




/Output CR 


OR 


FFH 




/Clear Z flag 


X\Jlt J. 

DEEM 


'Disk- 


■Error 


1 


DEFB 










HL 



Open file witli request for filename (ROPEN for read, WOPEN for write): 

TEXT2 
OPEN 



ROPEN 



WOPEN 



DEFM 


'Filename: ' 




DEFB 







LD 


HL, TEXT 2 




CALL 


2B75H 


Output text 


PUSH 


BC 


Save record length 


LD 


HL, 5B08H 


Buffer address 


LD 


B,18H 


Maximum length of input 


CALL 


5D9H 


Input filename 


LD 


C,B 




LD 


B,0 




PUSH 


HL 




ADD 


HL,BC 




LD 


(HL) , 


End marker 


POP 


HL 




LD 


DE, FCB , 


FCB address 


CALL 


OCEICH 


Copy filename 


CALL 


NZ, ERROR 


Call if error 


POP 


BC 


Restore record length 


JR 


NZ, OPEN 


Input new filename 


LD 


HL, BUFFER 


256 bytes buffer 


CALL 


0CE24H 


Open file 


RET 


z 


If no error return 


CP 


18H 


Test error code 


CALL 


NZ, ERROR 


Report error 


JR 


NZ, OPEN 


Enter new filename 


OR 


A 


File not found 


RET 






CALL 


OPEN 


Open file 


RET 


z 


If no error return 


CALL 


ERROR 


Report error 


JR 


ROPEN 


Try again 


CALL 


OPEN 


Open file 


JR 


Z, EXI 


If file already exists jump 


CALL 


0D694H 


Create file 


RET 


IXI 


If no error return 
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EXI 



TEXT3 



CALL 


ERROR 




; Report error 


JR 


WOPEN 




; Try again 


LD 


HL, TEXTS 




CALL 


2B75H 




;Ouput text 


CALL 


384H 




; Wait for key pressed 


CP 


'Y' 






RET 


Z 




; If file may be used . 


JR 


WOPEN 




; Try again 


DEEM 


'File 


alrea 


dy exists. ' 


DEFB 


ODH 






DEEM 


'Use anyway 


?' 


DEFW 


ODH 







Close file: 



CLOSE 


LD 


DE, FCB 




CALL 


0CE28H 




CALL 


NZ, ERROR 




JP 


NZ, PROG 




RET 




Write byte: 






WBYTE 


PUSH 


DE 




PUSH 


AF 




LD 


DE, FCB 




CALL 


IBH 




CALL 


NZ, ERROR 




JR 


NZ, PROG 




POP 


AF 




POP 


DE 




RET 





;FCB address 

/Close file 

; If failure report error 

;And jump to start of program 



; Save registers 

;FCB address 
/Write byte 



Read byte (Carry flag is set at end of file): 



RBYTE 



NOERR 
EOF 



PUSH 


DE 


; Save register 


LD 


DE, FCB 




CALL 


13H 


;Read byte 


JR 


Z, NOERR 


; If no error jump 


CP 


ICH 


;EOF code 


CALL 


NZ, ERROR 


; If not EOF report error 


JP 


NZ, PROG 




SCF 






JR 


EOF 




OR 
POP 


A 
DE 


; Clear carry flag 



Write a memory block from BSTART to BEND: 



SAVE 



LOOP 



LD 


B,0 


; Sector operation 


CALL 


WOPEN 


;Open file 


LD 


HL, BSTART-1 




LD 


DE, BEND 




INC 


HL 




LD 


A, (HL) 


;Byte into A 


CALL 


WBYTE 


; Write byte 


RST 


18H 


; Compare HL and DE 
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Load a memory block: 



iTR NZ,LOOP ;Loop if not equal 

JP CLOSE ; Close file 



LOAD 



LOOPl 



LD 


B,0 


; Sector operation 


CALL 


ROPEN 


;Open file 


LD 


HL, BSTART 




LD 


DE, BEND 




CALL 


RBYTE 


;Read byte 


RET 


C 


;If EOF then return 


LD 


(HL),A 


; Store byte 


INC 


HL 




JR 


LOOPl 


;Next byte 



The next two routines make it possible to use an opened file as a memory of 64 KByte at maximum. READ 
corresponds with LD A,(HL) and WRITE corresponds with LD (HL),A . 



SETPOS 


PUSH 


EC 




PUSH 


HL 




LD 


C,L 




LD 


L,H 




LD 


H,0 




CALL 


0CE4EH 




POP 


HL 




POP 


BC 




RET 




READ 


CALL 


SETPOS 




JR 


RBYTE 


WRITE 


CALL 


SETPOS 




JR 


WBYTE 



/Address to HLC 



; Set position 



; Set position 
/Read byte to A 
; Set position 
/Write byte 



Write records that contain a maximum of 20 characters, read from the keyboard: 



WRITEl 


LD 


B,20 




CALL 


WOPEN 


L00P2 


LD 


HL, BUFFEl 




LD 


B,20 




PUSH 


HL 




CALL 


5D9H 




POP 


HL 




JP 


C, CLOSE 




LD 


DE, FCB 




CALL 


0CE39H 




CALL 


NZ, ERROR 




JP 


NZ, PROG 




JR 


L00P2 



/Record length 
/Open file 
/ 20 byte buffer 
/Maximum length 

/Input from keyboard into buffer 

/ If BREAK key pressed jump 
/FCB address 
/ Write record 



/ Next record 



Read the fifth record of the file created above: 



READl 



LD 


B,20 


CALL 


ROPEN 


LD 


DE, FCB 


LD 


BC,4 


CALL 


0CE42H 


CALL 


NZ, ERROR 


JP 


NZ, PROG 


LD 


HL, BUFFEl 



/Record length 

/Open file 

/FCB address 

/Number of fifth record 

/Set position 



/20 byte buffer 
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CALL 0CE36H 

CALL NZ, ERROR 

JP NZ, PROG 
RET 



/Read record 



Calculate the sector number of the first directory sector of the floppy disk in drive 0: 



CALC 



LD 


A,0 


; Dri ve n umber 


CALL 


0CE5EH 


/Test drive 


CALL 


NZ, ERROR 




JP 


NZ, PROG 




LD 


HL, 


/Sector number 


LD 


DE;BUFFE2 


/256 byte buffer 


CALL 


0CF6FH 


/Read sector 


CALL 


NZ, ERROR 




JP 


NZ, PROG 




LD 


A, (BUFFE2+2} 


1 ; Third byte into A 


LD 


L,A 




LD 


H,0 




LD 


A, (5A0FH) 


/Granules per lump 


CALL 


0CE76H 


/Multiplication 


LD 


A, (5A12H) 


/Sectors per granule 


CALL 
RET 


0CE76H 


/Multiplication 
/Result in HL 



Calculate the number of free granules of the floppy disk in drive 0: 



CALCl 



L00P3 
L00P4 

NTFREE 



LD 

CALL 

CALL 

JP 

XOR 

CALL 

CALL 

JP 

LD 

LD 

LD 

LD 

LD 

LD 

LD 

LD 

RRA 

JR 

INC 

DJNZ 

INC 

DEC 

JR 

RET 



A, 

0CE5EH 

NZ, ERROR 

NZ, PROG 

A 

0D25FH 

NZ, ERROR 

NZ, PROG 

IX, 

A, (5A0FH) 

D,A 

A, (5A0BH) 

E,A 

HL, 5900H 

A, (HL) 

B,D 

C, NTFREE 

IX 

L00P4 

HL 

E 

NZ, L00P3 



/ Dri ve n uitiber 
/Test drive 



/A=0 

/Read directory sector 



/Set counter on 
/Granules per lump 

/Lumps on the floppy disk 

/Address of system buffer 
/Read byte into A 

/Bit into carry 

/If granule not free jump 

/ Increment counter 

/Next byte 

/Loop for every lump 
/Result in IX 



Change the name of the floppy disk: 



NEWNAM 



LD 


A,0 


/ Dri ve n umber 


CALL 


0CE5EH 


/Test drive 


CALL 


NZ, ERROR 




JP 


NZ, PROG 
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XOR A 

CALL 0D25FH 

CALL NZ, ERROR 

JP NZ, PROG 

LD DE, 59D0H 

LD HL, NAME 

LD BC, 8 

LDIR 

CALL 0D274H 

CALL NZ, ERROR 

JP NZ, PROG 
RET 



;Read directory sector 



; Address of floppy disk name in 

; buffer 

/Address of the new name 

/Length of the name 

/Replace old with new name 

/ Write directory sector back to 

/the fl oppy disk 



Insertion of an interrupt routine (the routine beeps every 2 seconds): 



PING 



INT 



LD DE, INT 

PUSH DE 
CALL 0CE13H 



POP DE 

CALL OCEl OH 
RET 

DEFW 

DEFB 80 

DEFB 80 

PUSH AF 

PUSH BC 

PUSH DE 

PUSH HL 

CALL 357CH 

POP HL 

POP DE 

POP BC 

POP AF 
RET 



/Address of interrupt routine 

/Just to be safe the routine is 
/ first removed from 
/the interrupt chain 

/Insert interrupt routine 

/Storage space for interrupt 

/vector 

/Starting value for counter 

/ 80* 2 5ms 

/ Counter 

/Save registers 



/ Beep 

/Restore registers 
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